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PLAN SERIES NETWORK OPERATING SYSTEM 


Nestar’s network software operating system is 

included as an integral part of all PLAN Series file 

servers. It provides system management and 

control commands, network utilities, print 

spooling, and full support of PC DOS and MS 

DOS. A summary of system operations follows. In END-USER/ SYSTEM MANAGER! 
this summary, keywords are indicated by capital PC WORKSTATION FILE SERVER CONSOLE 
letters; parameters are indicated by italics: optional 5 







parameters are indicated by square brackets, e.g., — 
[usage]. The system assigns default values, where =>. 
meaningful, when optional parameters are not 

specified. 









SYSTEM 
CONSOLE 
COMMANDS 


GETTING 
STARTED 


The operations/commands are organized in four 
categories: 


f. GETTING STARTED A 
E User boot from network. 
E The boot menu. 





SYSTEM 
Configuring driver. FILE SERVER UTILITIES 
A ANDS COMMANDS 





2 VIRTUAL PRINTERS 





3. SYSTEM COMMANDS 

E Local workstation commands. <> 

E Net commands. 

E Command parameters. 

E Commands in a program. VIRTUAL 
PRINTERS 
4.. CONSOLE OPERATIONS 

E Console commands. 

E Use of commands. 

E Utilities. 





Network commands are issued in three ways: (1) 
Use the NET program by typing NET at the DOS 
prompt; (2) Use the NEST program by including the 
NEST <command> statement in DOS batch 
files—the DOS ERRORLEVER wvill be set by the 
return code of the command; and (3) Use the 
N\V/CMDS program from the DOS prompt to 
create a command window, then <ctrl-f> to 
activate it. 


| PERSONAL COMPUTER-BASED LOCAL AREA NETWORKS 


_ GETTING STARTED 


E User Boot From Network 
At boot time, startup commands in your 
station’s profile will be executed and startup 
menu displayed. The profile used will be: 
1. //ISYSTEM/PROFILE/Snn. If this isn’t 
found, then: 
2. IISYSTEM/PROFILE/MENU. If this isn’t 
found, then: 
3. Enter profile pathname at prompt. 


E The Boot Menu 

When your profile has been found, any 
commands in its prolog will be executed, 
up to the word MENU. Any Menu header 
text will be displayed on the screen, and 
the Menu prompts from your profile will be 
displayed (optional). 


Configuring Driver 

If needed, use the NETCONFG program to 
reconfigure network driver and change 
default settings from the following default 
parameters: 


Parameter Default 
file server station SFE 
clicking on or off ON 
number of virtual disk drives 37 
device name of virtual printer BETI 


number of additional request blocks 4 


ı VIRTUAL PRINTERS 


Virtual printers accept input text and write 
it to a file server volume, where it is 
queued to a print server. 


E Available Header Items 


REQOTYPE:PRINT * 
ID:name 

USER: name 
NAME:name 
STATION: number 
DATE: timestamp 
TITLE: title 
SPOOLED:{ YES|NO| TEXT| DATA} 
TAG: identifier 
SERVER: { name| ANY} 
PRINTER: model 
SETUP:/forms 
COPIES:/n 

EJECT:/ 

TITLELINE: { YES| NO} 


* Required. All other items optional. Default values are underlined. 


E Virtual printer commands 


Access via NWU/CMDS <F10> or 
VPCMDS: 

.c close virtual printer spool file. 

-n clear virtual printer header. 

.S set virtual printer default size. 

.r reset virtual printer header to default. 

.p < pathname > send virtual printer spool 
file to < pathname > instead of queueing 
for print. 

.e<new escape sequence > set escape 
sequence to new two-character value. 

To use virtual printer commands from 
within a program, prefix the header item 
or command with the two-character 
sequence <esc>V. 









SYSTEM COMMANDS 


E Local Commands 


<Alt>999 
User abort key 
ranystring 
ignored as a comment 
PRINT anystring 
displays “anystring” on the screen 
command; command... 
Several file server commands can be 
entered on the same line if separated by 
semicolons. 


% filename 
causes commands to be read in from 
the DOS filename. 

NOECHO 
suppresses display of commands from 
a %file. 

SET FS STN $nn or @S$nn 
sets the default file server station to $nn. 
@$nn command sends only one 
command to file server $nn. 

SHOW/ FS 
displays file server to which commands 
are currently being sent. 

?d 
returns information about the specified 
drive “d” in the form 
72,FS= Snn,SFS= $nn,T =x, usage, 
SIZE = nnnn.b PS= xy,PE=nn, 
SS = xy, SE = NN 
where 
FS,SFS=$nn_ primary and secondary 

file server station 


addresses 

T=x volume type mounted 
(x=1,0,P etc.) 

usage access to volume 

SIZE size of volume in blocks 


PS,SS= xy primary/secondary file 
server read/write stations 
(see Idxyxy command) 
PE,SE=nn primary/secondary file 
server error codes 
?@ 
returns current default file server address. 
&snn 
turns on the secondary file server. 
SHOW DRIVES 
displays available drives and whether 
real or virtual volumes are mounted on 
them. For virtual volumes, also displays 
size, type, usage, and Shadow file server 
usage. 
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Idxyxy 

changes the status of drive d with 

respect to primary and secondary file 

servers as shown in the table. 

xy xy Meaning 

w -w _ Read data from primary 
Write data to primary and 
secondary (default when 
using Shadow) 

wie Read data from primary 
Write data to primary (turn 
off secondary; default 
when not using Shadow) 

e -w Read data from primary 
Write data to secondary 

-w rw Read data from secondary 
Write data to primary and 
secondary 

= rw Read data from secondary 
Write data to secondary 
(turn off primary) 


E Error Codes (PE = or SE=) 


nn Message Action 

1 Volume not mounted mount a volume 
and try again 

2 Internal error contact Nestar 
technical support 

3 Internal error contact Nestar 
technical support 

4 No read access remount with 
read access 

5 No write access remount with 


write access 
6 Read or write past end 


of volume reprogram 
7 ‘Internal error contact Nestar 
technical support 
8 File server disk error contact Nestar 
technical support 
9 Internal error contact Nestar 
technical support 
10 Network timeout retry the 
operation 
11 Protocol error contact Nestar 
technical support 
12 User abort self-explanatory 


E NET Commands 
To issue these commands, type NET 
command where “commana” is the 
desired file server command. You can also 
press <Ctrlf> to open a command 
window. You then type the command in 
the window and type < Ctrl-f> to close 
-the window. 


BLOAD pathname [, LOAD = address] 

a loads binary virtual disk. 

= loads at LOAD address in BLOAD, if 
present; if not, loads at LOAD address in 
corresponding BSAVE, if present; 
otherwise, loads at FROM address in 
BSAVE. 

= LOAD = xxxxyyyy where 
XXXX = segment, yyyy = Offset. 


BRUN pathname [, LOAD = address] 

[,EXEC = address] 

=" BLOADS a binary virtual disk, then 
executes it starting at the 
EXEC = address, if present; otherwise at 
EXEC address specified on file creation: 
otherwise at first address loaded. 


BSAVE pathname,FROM = address, size 
[ LENGTH = number] [LOAD = address 
[, EXEC = address] 

a saves memory image on disk. 


CREATE pathname type [, size] [, Sectors] 

[, protection] [, drive [, usage] 

[, LOAD = number] [[ LENGTH = number] 

[EXEC = number] 

= creates and optionally mounts a new 
virtual disk. 

a Do not use CREATE in the IBM PC DOS 
environment. Use INIT command 
instead. 

DELETE pathname 

a deletes a virtual disk from system. 


HELP [command name] or 

? [command name] 

® displays list of Commands or syntax of 
specified command. 


INIT pathname, drive |, size] [,SYS] 
LENTRIES = entries] [| VOLNAME = name] 
[protection] [, Usage] 

= creates, mounts and initializes a virtual 
disk of any size (certain environments 
only), with specified number of entries in 
the root directory. VOLNAME is the DOS 
name to be assigned to the volume, 
if any. 

LIST [pathname] [, VERBOSE] [, NESTED] 

® lists entires in default or specified directory. 

= VERBOSE gives size of each volume. 

= NESTED lists entire hierarchy of 
directories. 

LOCK /ockname [: password] [, usage] 

[, USERS = number] [VAL = number] 

a (in one line) locks “lockname” for 
exclusive (EXEC) or shares (SHR) use, 
protected by the password if given. 

= defines maximum number of users by 
the USERS parameter. 

a assigns an integer lock value with VAL 
parameter. 


LOCK + lockname 

a increments lock value and returns old 
value. 

LOCK — /ockname 

= decrements lock value and returns old 
value. 

MOUNT pathname. drive [, usage] 

= establishes a correspondence between a 
virtual disk and a drive. 

MOVE old pathname,new pathname 

a moves a volume or subtree (directory 
plus all its branches) from its current 
directory to a new directory. 

OFF 

a unmounts all volumes, unlocks all locks, 
and clear any passwords or DIRS set. 

PROTECT [pathname [, protection] 

a modifies passwords or access rights for a 
virtual disk or directory. 

READLOCK /ockname 

= returns Current lock value. 

REMOUNT drive [usage] 
or 

REMOUNT ALL [, Usage] 

m changes the usage of mount on drive as 
specified. 


RENAME old pathname, newname 

a renames specified file server volume or 
directory. 

SET [GRPPW = password] 

[PRVPW = password] 

= sets default group or private password. 

SET DIR [pathname] 

® if no pathname is given, clears default 
directory, 

SHOW DATE 

a displays dates. 

SHOW DIR 

a displays name of current default directory. 

SHOW ID 

a displays file server ID number. 

SHOW INFO 

a displays information on a virtual volume. 

SHOW LOCK [/ockname] 

a lists all stations using specified lockname. 

SHOW [ALL] LOCKS 

a displays all locks set at own station or 
held in file server. 

SHOW [ALL] MOUNTS [pathname] 

a gives information on virtual disks 
mounted on the file server. 

SHOW PROTECTION [pathname 

= displays group, private, and public access 
rights for pathname. 

SHOW STATION 

a displays own station number. 


SHOW TIME 
= returns current day of week, date and 
time. 


SHOW TYPE drive 

™ displays type of virtual disk mounted on 
drive specified. 

SHOW TYPES 

a displays types of virtual disks mounted on 
drives B: through O:. 

SHOW VERSION 

= returns Current version number of the file 
server software. 

SHOW VOLS 

= displays names of disk units currently 
operating in the file server. 

TIMESTAMP 

= returns encoded form of current date and 
time. 

UNLOCK /ockname 
or 

UNLOCK ALL 

= releases locked usage on a lockname or 
on all locknames currently held. 


UNMOUNT drive 

or 
UNMOUNT ALL 
a cancels previous mount(s). 
WRITELOCK /lockname, VAL = number 
m sets current lock value. 
a returns old lock value. 


E Command Parameters 


access rights 
R (read), W (write), E (erase), C (create), 
D (delete), and X (execute). 
address 
XxXxX = segment, yyyy = Offset. 
drive 
a letter from A-Z followed by a colon. 
filepath 
name [:password] [/filepath]. 
lockname 
(same restrictions as name). 
name 
name of disk unit, directory, or virtual 
volume: 1-15 characters: no commas, 
contro! characters, slashes, colons, 
retums or unprintable characters; 
imbedded blanks ok. Allowed 
characters: A-Z, 0-9, 7 1° #3 ARNT? 
> <[] @-|. 
number 
if decimal, between -2 ~ 31 to 2- 31-1 
inclusive; 
if hex, between $O and SFFFFFFFF 
inclusive. 


password 
secret word used to gain access to 
protected volumes. Same restrictions as 
name, except control characters 
allowed. 
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pathname 
unitname filepath or filepath 
(80 characters max.) Initial slash indicates 
first field is unit name; no initial slash 
indicates current default directory is to be 
prefixed to pathname. 


protection 
PUBACC access rights (Default: R) 


GRPACC access rights (Default: PUBACC) 


PRVACC access rights (Default: varies) 
GRPPW/ password, 
PRVPV/ password 

type 
T=! (IBM PC DOS) T =B (binary) 
T=U (IBM PC p-System) T=Z (system) 
T=C (Apple CPM) T=T (Text) 





4, CONSOLE OPERATIONS 


E Console Commands 
CLEAR 
clears console display. 
DISPLAY ON/OFF 
sets display. 
DISPLAY RECON ON/OFF 
sets display of network reconfiguration 
activity. 
MODEM ON/OFF 
allows remote diagnostics. 
PASSW/ORD [pw] 
sets password for console commands. 
QUIT 
shuts down file server program; displays 
file server utility menu. 


E Use of commands 

These OFFLINE utility programs can only 
be run on the file server and cannot be run 
while the file server program is operating. 
ONLINE utilities are executed at user 
stations while the file server is operating, 
and are documented in the File Server User 
Guides. 


To execute utility programs, turn on the file 
server. Boot from the default disk or press 
any key, when prompted, to see the boot 
menu and boot from the disk (or tape, in 
an emergency) that you prefer. If a disk 
problem is suspected, do not boot from the 
disk to be examined. Reach the utility 
menu by pressing <Esc> when 





CHECK/REPAIR DISK CONSISTENCY 
verifies the consistency of disk data 
structures and optionally repairs the data 
structures. 


FORMAT DISK 
Offline utility initializes disk for use with 
the file server. Hard disks are shipped 
already formatted and should not be 
reformatted except under special 
circumstances. 


ADD OR MODIFY TAPE DUMP 
INSTRUCTION FILES 
allows predefining of Partial Tape 
Dump/Restore and Tape Dump/Restore 
operations (used by the Partial Tape 
Dump/Restore utility. 





T=D (Apple DOS) T=Y (directory! SET TIME prompted. 
T=P (Apple Pascal) T =X (user defined) | sets clock/calendar. 
T=3 (Apple SOS) T=R (request volume, | SHOW ALL MOUNTS 
used by servers) | displays current mounts. 
unit | SHOW TIME 
C: character (1 byte) | displays current day and time. 
S: sector (256 bytes) | SUPER cmd From the utility menu, type the letter for MODEM ON/OFF/SETUP 


B: block (512 bytes) 
K: (1024 bytes) 
blank (default): block (512 bytes) 
unitname 
1, 2, 3 or 4 [:password]: or 
name [:password] 
usage 
one of: EXC (exclusive), SHR (shared), or 
UPD (update) 
one of: RO (Read Only) or RW (Read 
Write) 
UPD allows one user RW access, others 
RO, SHR 


volume size 
SIZE = number [.unit] 


E Commands in a program 


BASIC: 

= CALL FSCMD (cmd$) 

m CALL FSRSP (rsp$,rlen%) 

= rsp$ =LEFTS (rsp$,rlen%) 

COBOL: 

a CALL “FSCMD” USING COMMAND. 

a CALL “FSRSP” USING RESPONSE. 

C: 

a int FSCMD (station, cmd, rsp, newcmd, 

done) 

= char station, *cmd, *rsp; 

€ int newcmd, *done; 

PASCAL: 

A. CMDUNIT—file server and local 

commands 
PROCEDURE Cmd 
(Comm:CmdLongstr; Options: 
INTEGER); 
PROCEDURE CmdLoop 
(Prompt:Ls80); 
PROCEDURE CmdExec 
(VAR fil:CmdFile); 
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overrides file server passwords on 
network volumes for current command 
only. 

$nn cmd 
executes a command for network user 
station Snn. 

$nn SUPER cmd 
overrides passwords on command to be 
executed for user station. 


B. NETUNIT—file server commands 
FUNCTION FSCMD (Station:Station 
Typ; Cmd:NetLongstr: 

VAR Rsp:NetStr80): INTEGER; 
FUNCTION FSCMD1 
(Station:StationTyp; Cmd:NetLongstr; 
VAR R sp:NetStr80); 
NewCmd:BOOLEAN; 

VAR Done:BOOLEAN): INTEGER; 
FUNCTION DevSet 
(DeviceName:CHAR; Stn:StationTyp): 
INTEGER; 

FUNCTION DevFree 
(DeviceName:CHAR): INTEGER; 
FUNCTION Devinfo 
(DeviceName:CHAR); VAR D: 
DeviceDesc}; 
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the utility to be executed. Then supply 
information as requested. 


E Utilities 
FILE SERVER 


causes the file server software to execute 
the online file server program. 


PARTIAL TAPE DUMP/RESTORE 
copies selected hard disk volumes to and 
from backup tape cartridges. 

FULL TAPE DUMP/RESTORE 
copies all the volumes on a hard disk 
onto backup tape cartridges, and 
restores all copied volumes from tape 
to disk. 


COPY PARTIAL DISK TO DISK 
copies from one disk location to another. 


COPY FULL DISK TO DISK 
copies entire volumes of data between 
media that are of identical size. Copies 
the FULL hard disk; use the Copy Partial 
Disk Option to copy selected volumes. 
Destroys existing information on target 
disk. To ABORT, press <Esc> 
< Return > whenever this utility 
requests a reply; or press <Esc> during 
copying process. WARNING: If 
interrupted, target disk will not be 
usable until it is reformatted by 
FORMAT program or until it is the 
target of a successfully completed full 
disk copy. 

LIST DISK CONTENTS 
creates a print server listing of some or all 
of the files on disks attached to the file 
server. 

EXAMINE/MODIFY DISK CONTENTS 


used for a variety of disk maintenance 
and diagnostic purposes. 


allows use of a modem and remote 
console, for file server diagnostics via 
telephone. 


NESTAR SYSTEMS INC. 
1345 Shorebird Way 
Mountain View, CA 94043 
(415) 969-1777 


Regional Offices in: 
Chicago; Dallas; Detroit; 
Irvine; Los Angeles; 
Minneapolis; New York; 
Toronto; Washington, D.C. 
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Telephone: 44-895-59831 
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